---
kind: external_dependency
name: ESP-IDF v5.x 构建框架（ESP32-S3 固件构建系统）
slug: esp-idf
category: external_dependency
category_hints:
    - framework_behavior
    - client_constraint
scope:
    - '**'
source_files:
    - esp32s3/firmware/README.md
    - esp32s3/firmware/boards/sdkconfig.base
---

# ESP-IDF v5.x
- **角色**：ESP32-S3 产品线的底层构建框架，MicroPython 作为 FreeRTOS 任务运行其上；提供 `idf.py` 构建工具链、组件管理、NVS 存储、WiFi/BLE 协议栈等。
- **集成点**：`esp32s3/firmware/` 下通过 CMake + ESP-IDF 组件模型组织，板型配置位于 `boards/`（mpython_v3 / labplus_Ledong_v2 / labplus_for_xuejing / labplus_xunfei_js_*），各板型通过独立的 `sdkconfig.*` 文件组合启用功能（BLE、SPIRAM、WiFi 等）。
- **约束**：仅支持 ESP-IDF v5.0.4 / v5.0.5 / v5.1.2 / v5.2.0；Windows 开发推荐使用 WSL 安装工具链；构建产物为 bootloader.bin + partitions.bin + micropython.bin 三合一固件镜像。
- **对比**：ESP32 产品线仍使用 Makefile + 旧版构建流程，两条产品线构建系统不兼容。